home *** CD-ROM | disk | FTP | other *** search
/ Wildcat Gold - The Optical BBS / Wildcat Gold - The Optical BBS (The Golden ROM Series)(Volume 4 Number 1)(The Digital Publishing Company)(1992).ISO / sdn / 4dos400p.sdn / APPNOTES.DOC < prev    next >
Text File  |  1991-11-18  |  69KB  |  1,567 lines
  1.  
  2.  
  3.                             4DOS Application Notes
  4.  
  5.                        Version 4.0 -- November 18, 1991
  6.  
  7.  
  8.    Copyright 1988 - 1991, JP Software Inc., All Rights Reserved.  Published
  9.    by JP Software Inc., P.O. Box 1470, E. Arlington, MA 02174 USA, (617)
  10.    646-3975.
  11.  
  12.  
  13.    This file provides information on using 4DOS with a variety of other
  14.    software products.  It is intended for use whenever you have a question
  15.    about using another product with 4DOS, or suspect a compatibility
  16.    problem.
  17.  
  18.    Inclusion of a product in this file does NOT mean there are compatibili-
  19.    ty problems with it!  It only indicates that we have some information
  20.    that may be useful to you when you use the product with 4DOS.
  21.  
  22.    This file is formatted at 58 lines per page, and contains form feeds and
  23.    page footers.  It can be viewed with a file viewer such as the 4DOS LIST
  24.    command, or printed on most PC printers using the command:
  25.  
  26.               copy appnotes.doc prn
  27.  
  28.    Printing it with a program that formats the pages is not likely to work
  29.    due to the formatting included in the file.
  30.  
  31.    Our customers regularly ask us for recommendations on software to use
  32.    with 4DOS.  While we can't tell you what is best for your use or your
  33.    system, at the end of this file we have included some comments on soft-
  34.    ware we like and have found useful on our own systems here at JP
  35.    Software.
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                        page 1
  58.  
  59.  
  60.  
  61.                                Table of Contents
  62.  
  63.    Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . .    3
  64.  
  65.    General Information . . . . . . . . . . . . . . . . . . . . . . . .    4
  66.       Running 4DOS along with COMMAND.COM  . . . . . . . . . . . . . .    4
  67.       Executing DOS Commands via Interrupt 2E  . . . . . . . . . . . .    6
  68.       Swapping to RAM Disks  . . . . . . . . . . . . . . . . . . . . .    6
  69.       4DOS and Other Command Line Editing Programs . . . . . . . . . .    6
  70.       4DOS and EXE File Compression Programs . . . . . . . . . . . . .    7
  71.       4DOS.COM and C Language exec() Functions . . . . . . . . . . . .    7
  72.       Mouse Compatibility with 4DOS HELP . . . . . . . . . . . . . . .    7
  73.  
  74.    Information on Specific Products  . . . . . . . . . . . . . . . . .    9
  75.       MS-DOS APPEND Command  . . . . . . . . . . . . . . . . . . . . .    9
  76.       MS-DOS DATE and TIME Commands  . . . . . . . . . . . . . . . . .   10
  77.       MS-DOS FASTOPEN Command  . . . . . . . . . . . . . . . . . . . .   11
  78.       MS-DOS 4.0 and 5.0 FORMAT /S Command . . . . . . . . . . . . . .   11
  79.       MS-DOS 4.0+ SELECT Command . . . . . . . . . . . . . . . . . . .   11
  80.       1DIR+ (Bourbaki) . . . . . . . . . . . . . . . . . . . . . . . .   11
  81.       ANSI.SYS (various manufacturers) . . . . . . . . . . . . . . . .   12
  82.       Bookshelf CD-ROM (Microsoft) . . . . . . . . . . . . . . . . . .   12
  83.       DESQView (Quarterdeck) . . . . . . . . . . . . . . . . . . . . .   13
  84.       DR-DOS (Digital Research)  . . . . . . . . . . . . . . . . . . .   13
  85.       Epsilon (Lugaru Software)  . . . . . . . . . . . . . . . . . . .   16
  86.       GeoWorks Ensemble (GEOS) . . . . . . . . . . . . . . . . . . . .   17
  87.       Hijaak (Inset Systems) . . . . . . . . . . . . . . . . . . . . .   17
  88.       LOGIMENU (Logitech)  . . . . . . . . . . . . . . . . . . . . . .   17
  89.       Manifest (Quarterdeck) . . . . . . . . . . . . . . . . . . . . .   17
  90.       MOVE-EM (Qualitas) . . . . . . . . . . . . . . . . . . . . . . .   18
  91.       Netware (Novell) . . . . . . . . . . . . . . . . . . . . . . . .   18
  92.       Novell MENU (Novell) . . . . . . . . . . . . . . . . . . . . . .   20
  93.       OS/2 1.3 and 2.0 (IBM) . . . . . . . . . . . . . . . . . . . . .   20
  94.       PC Tools (Central Point Software)  . . . . . . . . . . . . . . .   20
  95.       Personal REXX (Quercus Systems)  . . . . . . . . . . . . . . . .   20
  96.       QEMM and QRAM (Quarterdeck)  . . . . . . . . . . . . . . . . . .   21
  97.       SigmaPlot (Sigma Designs)  . . . . . . . . . . . . . . . . . . .   22
  98.       Software Carousel (SoftLogic Solutions)  . . . . . . . . . . . .   22
  99.       TSRCOM Utilities (TurboPower Software) . . . . . . . . . . . . .   23
  100.       UltraVision (Personics)  . . . . . . . . . . . . . . . . . . . .   24
  101.       Ventura Publisher (Xerox)  . . . . . . . . . . . . . . . . . . .   24
  102.       Windows 3.0 (Microsoft)  . . . . . . . . . . . . . . . . . . . .   24
  103.       Programs Requiring PATH to be Under 128 Characters . . . . . . .   24
  104.           Computer Select CD-ROM Database (Ziff-Davis) (25)
  105.           RenderMan (AutoDesk) (25)
  106.           VINES Network (Banyan) (25)
  107.           Windows 3.0 (Microsoft) (25)
  108.  
  109.    Software For Use With 4DOS  . . . . . . . . . . . . . . . . . . . .   26
  110.  
  111.  
  112.  
  113.  
  114.  
  115.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                        page 2
  116.  
  117.  
  118.  
  119.    Introduction
  120.    ------------
  121.  
  122.    We have made every effort to ensure that this file is as accurate and up
  123.    to date as possible.  Our information is based on our own investiga-
  124.    tions, reports from 4DOS beta testers, technical support calls, discus-
  125.    sions with manufacturers of other products, and reports from our custom-
  126.    ers.  Unfortunately, varying conditions between systems or between
  127.    software releases can easily invalidate the results of previous tests. 
  128.    Therefore we cannot guarantee that every item in this file is accurate
  129.    for all systems or will remain accurate over time; you may have to do
  130.    your own testing to determine what works well on your system with the
  131.    software you own.
  132.  
  133.    If you have a question or problem related to another program, first read
  134.    through chapter 7 of the 4DOS manual ("Using 4DOS With Your Hardware And
  135.    Software").  Chapter 7 gives general suggestions for using 4DOS with
  136.    other products and for solving compatibility problems, and should always
  137.    be used along with this file.
  138.  
  139.    If the information in Chapter 7 doesn't help, check below for both
  140.    additional general suggestions which pertain to your question, and
  141.    information on the specific product you are working with.  Please note
  142.    that some products are listed by category rather than or in addition to
  143.    specific listings by product name; check the Table of Contents carefully
  144.    to see where any particular product may be covered.
  145.  
  146.    Many of the items below refer to the 4DOS.INI file.  See chapter 6 of
  147.    the manual for a complete explanation of 4DOS.INI and the directives
  148.    which can be used there.  If you have a printed manual, also check
  149.    MANMOD.DOC for directives which were added or modified since the manual
  150.    went to press.
  151.  
  152.    Virtually all of your software will work with 4DOS with no trouble.  If
  153.    you do find an interaction or compatibility problem, it can probably be
  154.    diagnosed easily with one of three methods:  checking this file for
  155.    specific information; trying different 4DOS swapping methods; and test-
  156.    ing for interactions by removing all drivers and TSRs which are not
  157.    absolutely necessary and then replacing them one at a time.  These
  158.    methods and other related techniques are described in Chapter 7 of the
  159.    manual.
  160.  
  161.    Many popular software products are not covered in this file.  If a
  162.    program does not appear here, it simply means that as far as we know no
  163.    additional information is necessary or useful when using that program
  164.    with 4DOS.
  165.  
  166.    If you have a question or problem related to how 4DOS works with other
  167.    hardware or software products, and it isn't addressed in chapter 7 or by
  168.    these notes, contact JP Software or your dealer for technical support.
  169.  
  170.  
  171.  
  172.  
  173.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                        page 3
  174.  
  175.  
  176.  
  177.    General Information
  178.    -------------------
  179.  
  180.       Running 4DOS along with COMMAND.COM:
  181.  
  182.           You may find a very rare program which will not work under 4DOS,
  183.           but runs properly under COMMAND.COM.  If you have determined that
  184.           the problem cannot be solved through configuration changes or by
  185.           eliminating or reconfiguring a third program which is causing the
  186.           problem, use this section to see how to run 4DOS and COMMAND.COM
  187.           together in order to diagnose such a problem.
  188.  
  189.           There are two methods of loading COMMAND.COM before another pro-
  190.           gram.  The first is to load it only when a specific program is
  191.           running.  This can be accomplished with the following command
  192.           (assuming COMMAND.COM is in the root directory of drive C:):
  193.  
  194.                     c:\command /c progname options
  195.  
  196.           where "progname" is the program name (with path if necessary) and
  197.           "options" are any parameters for the program.  This command will
  198.           run COMMAND.COM, load and run the program, and upon exit from the
  199.           program will exit from COMMAND.COM and return to 4DOS.  If this
  200.           is necessary to run a specific program, it can be defined as an
  201.           alias:
  202.  
  203.                     alias progname `c:\command /c progname %&`
  204.  
  205.           The "%&" passes all command line arguments on to the program.
  206.  
  207.           With this method, if the program is large COMMAND.COM may need to
  208.           reload itself when the program exits.  It will not be able to do
  209.           so unless the COMSPEC is set properly.  If you experience prob-
  210.           lems such as "Invalid COMMAND.COM" errors when using this method,
  211.           use a batch file like the following to run the program in ques-
  212.           tion (the SETLOCAL and ENDLOCAL cause COMSPEC to be restored to
  213.           its previous value after the program exits).  You will need to
  214.           modify this file if your copy of COMMAND.COM is not stored in the
  215.           C:\ directory:
  216.  
  217.                     setlocal
  218.                     set comspec=C:\COMMAND.COM
  219.                     c:\command /c progname %&
  220.                     endlocal
  221.  
  222.           The second method is more drastic:  you can start your system
  223.           under COMMAND.COM, then run 4DOS.  This approach is rarely neces-
  224.           sary, and will use about 4 - 5K of additional RAM for the resi-
  225.           dent portion of COMMAND.COM.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                        page 4
  232.  
  233.  
  234.           The following steps will set your system up to boot with
  235.           COMMAND.COM, and run 4DOS automatically as part of the boot pro-
  236.           cess:
  237.  
  238.               (1) Set up the SHELL= statement in CONFIG.SYS to run
  239.               COMMAND.COM, or leave it out entirely.  In other words, set
  240.               it up just as you would if 4DOS were not on your system.
  241.  
  242.               (2) Separate your AUTOEXEC file into two parts:  part 1,
  243.               which remains in AUTOEXEC.BAT, should contain any commands
  244.               you wish to have COMMAND.COM execute before 4DOS is started. 
  245.               This might include loading any TSRs which you cannot get to
  246.               load properly under 4DOS.  Part 2, which you must place in a
  247.               separate batch file (we suggest the name 4DAUTO.BAT, but you
  248.               can use any name with a .BAT or .BTM extension), should con-
  249.               tain the commands you wish to have 4DOS execute when it is
  250.               started.
  251.  
  252.               (3) Place the following line as the last line in the modified
  253.               AUTOEXEC.BAT:
  254.  
  255.                     4DOS parameters filename
  256.  
  257.               where "parameters" represents the appropriate 4DOS parameters
  258.               for swapping, environment and history size, etc. (see the
  259.               Installation section of the manual), and "filename" is the
  260.               name of the new batch file you created for part 2 of your old
  261.               AUTOEXEC file.  Do NOT include a /P in the "parameters" or
  262.               4DOS will re-run AUTOEXEC and therefore load itself again, ad
  263.               infinitum!
  264.  
  265.               (4) Be sure that KSTACK.COM is loaded in your AUTOEXEC.BAT
  266.               file or your 4DOS startup file if you wish to use the 4DOS
  267.               KEYSTACK command.
  268.  
  269.           This will load COMMAND.COM, execute the commands in AUTOEXEC,
  270.           load 4DOS, execute the commands in your new batch file, and then
  271.           give you the normal 4DOS prompt.
  272.  
  273.           There is one drawback to this second approach:  because 4DOS is
  274.           not loaded with a /P, the EXIT command will return you to
  275.           COMMAND.COM if you inadvertently enter it at the primary shell
  276.           prompt.  You can get around this by including the /P parameter
  277.           despite the caution above, and then placing the following line at
  278.           the start of AUTOEXEC.BAT:
  279.  
  280.                     if "%@eval[2+2]"=="4" quit
  281.  
  282.           This line tests the 4DOS variable function %@EVAL, which will
  283.           return "4" under 4DOS and remain unchanged under COMMAND.COM.  If
  284.           %@EVAL returns a "4" the statement QUITs the batch file, prevent-
  285.           ing the infinite loop described above.
  286.  
  287.  
  288.  
  289.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                        page 5
  290.  
  291.  
  292.  
  293.       Executing DOS Commands via Interrupt 2E:
  294.  
  295.           COMMAND.COM contains an undocumented feature which allows pro-
  296.           grams to execute DOS commands by passing the command through
  297.           software interrupt number 2E (hex).  Very few programs use this
  298.           feature, but full, documented support for it is available within
  299.           4DOS for those circumstances where it's needed.
  300.  
  301.           If you have a program which is supposed to execute DOS commands
  302.           and it does not work under 4DOS, first read Chapter 7 of the
  303.           manual, check your COMSPEC setting, and check that enough memory
  304.           is available for 4DOS to execute as a secondary shell.  If these
  305.           appear correct, and the program still doesn't work, it may be
  306.           trying to use INT 2E to execute commands.
  307.  
  308.           If you believe this is the case, try setting the FullINT2E direc-
  309.           tive in 4DOS.INI to Yes:
  310.  
  311.                     FullINT2E = Yes
  312.  
  313.           (see chapter 6 of the manual for more information on 4DOS.INI). 
  314.           Full INT 2E support is normally left disabled because it adds
  315.           about 100 bytes to the resident size of 4DOS, and it isn't needed
  316.           in most circumstances.
  317.  
  318.           See Appendix C of the ASCII manual, or the MANMOD.DOC file if you
  319.           have a printed manual, for technical details on the INT 2E inter-
  320.           face.
  321.  
  322.  
  323.       Swapping to RAM Disks:
  324.  
  325.           In order to swap the primary shell to a RAM disk the RAM disk
  326.           must be completely defined in CONFIG.SYS via a DEVICE= statement
  327.           (most RAM disks are set up this way).  RAM disks completely or
  328.           partially defined in AUTOEXEC.BAT (such as the RAM disk / cache
  329.           combination in Multisoft's PC Kwik Power Pak) cannot be used for
  330.           swapping the primary shell, because AUTOEXEC.BAT has not been
  331.           executed at the time that the root shell is loaded, and hence the
  332.           RAM disk does not exist at that point.
  333.  
  334.  
  335.       4DOS and Other Command Line Editing Programs:
  336.  
  337.           Programs such as Anarkey (Moderne Software), PCED (Cove Soft-
  338.           ware), and ReDOS (Multisoft) will work properly with 4DOS.  How-
  339.           ever these programs require the use of SETDOS /L1 to operate,
  340.           which will disable 4DOS's command recall and command line edit-
  341.           ing.  In most cases you will be able to switch back and forth
  342.           between 4DOS editing and the other editor by toggling the SETDOS
  343.           /L state.
  344.  
  345.  
  346.  
  347.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                        page 6
  348.  
  349.  
  350.           When another editor is used 4DOS's command history will be main-
  351.           tained, and can be viewed with HISTORY, but will not be available
  352.           for recall until a SETDOS /L0 is executed.  4DOS aliases, execut-
  353.           able extensions, and other features will be active regardless of
  354.           the SETDOS /L state.  Aliases will be processed after any pro-
  355.           cessing done by the other editing program.  You must use care
  356.           with other programs that provide an aliasing capability to avoid
  357.           confusion if a command is expanded by both the other program and
  358.           4DOS!
  359.  
  360.  
  361.       4DOS and EXE File Compression Programs:
  362.  
  363.           If you use a file compression program like PKLITE, LZEXE, or
  364.           DIET, you must use caution when compressing 4DOS files.  You
  365.           should be able to compress the 4DOS.COM file with no trouble. 
  366.           However if you have a copy of 4DOS that you intend to brand with
  367.           your name and serial number, you must brand it BEFORE you run the
  368.           file compression program, or the BRAND program will fail.  Simi-
  369.           larly, HELPCFG will not be able to modify your HELP system colors
  370.           if you compress the 4HELP.EXE program.  The only compressed pro-
  371.           gram files distributed with 4DOS are HELPCFG.EXE, and 4MAKE.EXE
  372.           on the 4DOS / 4OS2 Utility Disk; these files are compressed with
  373.           the PKLite Professional package.
  374.  
  375.  
  376.       4DOS.COM and C Language exec() Functions:
  377.  
  378.           Most PC implementations of the C language contain an exec() func-
  379.           tion which overlays the C program with a new program.  These
  380.           exec() functions load .COM and .EXE files differently.  Some
  381.           exec() functions determine which type of file they are executing
  382.           based on the "header" contained in the file (this is the method
  383.           normally used by DOS), but others -- including those used in
  384.           Borland C++ and Lattice C -- use the file extension to determine
  385.           the loading method.  Those exec() functions which use the file
  386.           extension will not work properly if they attempt to run 4DOS.COM,
  387.           because 4DOS.COM is actually an EXE file (these same functions
  388.           will fail with any file whose extension does not match its type,
  389.           even though such files can be executed properly by DOS itself). 
  390.           The workaround for this problem is to rename 4DOS.COM to
  391.           4DOS.EXE, or make a copy of 4DOS.COM and call it 4DOS.EXE.
  392.  
  393.  
  394.       Mouse Compatibility with 4DOS HELP:
  395.  
  396.           The 4DOS HELP system depends on correct operation of your mouse
  397.           driver.  If your mouse doesn't work in HELP, or you have trouble
  398.           with mouse "droppings" (characters left behind by the mouse cur-
  399.           sor), be sure you have the most up to date working version of
  400.           your mouse driver that is available.  Users of Microsoft serial
  401.           and PS/2 mice may notice a long delay when the HELP system
  402.  
  403.  
  404.  
  405.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                        page 7
  406.  
  407.  
  408.           starts.  This is due to the long initialization time required for
  409.           these mice, and is a function of the mouse driver, not the HELP
  410.           system.  If you don't use the mouse in HELP and want to speed up
  411.           HELP startup, set HelpOptions = /X in 4DOS.INI.  This will dis-
  412.           able all mouse access in the HELP system.
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                        page 8
  464.  
  465.  
  466.  
  467.    Information on Specific Products
  468.    --------------------------------
  469.  
  470.    The information below is listed alphabetically by product, with manufac-
  471.    turers' names included.  MS-DOS commands are listed before other soft-
  472.    ware products.
  473.  
  474.    Items marked with two asterisks [**] after the product name were sup-
  475.    plied by users, and have not been tested by JP Software.
  476.  
  477.  
  478.       MS-DOS APPEND Command:
  479.  
  480.           Unlike most other commands in MS-DOS, APPEND has both an external
  481.           portion and an undocumented internal portion.  The first time
  482.           APPEND is run the external portion is executed, and loaded into
  483.           memory as a TSR (memory-resident program).  Subsequent uses of
  484.           APPEND to adjust the APPEND path use an undocumented internal
  485.           interface between COMMAND.COM and the TSR portion of APPEND.
  486.  
  487.           4DOS does not support the internal portion of APPEND command. 
  488.           This means that you cannot change the APPEND path directly from
  489.           4DOS.  However you can still use APPEND with 4DOS.
  490.  
  491.           APPEND should initially be loaded in the usual way, from AUTOEXEC
  492.           or any other batch file, or from the command line.  However to
  493.           change the APPEND path after APPEND has been loaded for the first
  494.           time, you must run APPEND from COMMAND.COM, not from 4DOS.  To do
  495.           this, enter the following command (modify the command
  496.           appropriately if COMMAND.COM is not in the directory C:\):
  497.  
  498.                     c:\command /c append [new append path list]
  499.  
  500.           You could also set up a 4DOS alias to do the above command for
  501.           you, for example:
  502.  
  503.                     alias app `c:\command /c append`
  504.  
  505.           which would be invoked with the command
  506.  
  507.                     app [new path list]
  508.  
  509.           The /X switch can be used, and it will affect 4DOS directory
  510.           searches for many 4DOS commands (as it does for COMMAND.COM). 
  511.           Please note that this makes APPEND very dangerous:  if you APPEND
  512.           a directory with /X and then (say) delete *.BAK when no such
  513.           files exist in the current directory, then the .BAK files in the
  514.           APPENDed directory will be deleted instead.
  515.  
  516.           The APPEND /E switch will not work with 4DOS.
  517.  
  518.  
  519.  
  520.  
  521.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                        page 9
  522.  
  523.  
  524.       !   CAUTION:  In our opinion APPEND is an extremely dangerous com-
  525.           mand.  It is capable of "fooling" programs into thinking they are
  526.           accessing one file when they are really accessing another one
  527.           with the same name in a different directory.  This can either do
  528.           just what you want, or cause all sorts of trouble, depending on
  529.           the circumstances.  In particular, this behavior can cause 4DOS
  530.           to place descriptions which go with files in one directory in the
  531.           description file for another directory, because with APPEND run-
  532.           ning 4DOS can't tell whether APPEND has opened a file different
  533.           from the one it asked for.
  534.  
  535.           If you must use APPEND to make certain applications work, we
  536.           STRONGLY suggest that you set up the aliases described above, and
  537.           load APPEND in AUTOEXEC.BAT with an empty path.  Then, for each
  538.           application, set up an alias to run it that is similar to the
  539.           following:
  540.  
  541.               alias myprog `app c:\mydata^d:\util\myprog.exe^app ;`
  542.  
  543.           This alias sets the APPEND path, runs the application, and clears
  544.           the APPEND path.  When used in this way APPEND is less likely to
  545.           cause trouble because it is disabled except when it is explicitly
  546.           needed.
  547.  
  548.           In MS-DOS version 4.0 the new APPEND /PATH:OFF switch mitigates
  549.           this problem somewhat; in particular it will keep 4DOS file de-
  550.           scription files from getting mixed up between directories.  For
  551.           this reason 4DOS will automatically set this switch if it detects
  552.           that you are running APPEND and DOS 4.0 or above.
  553.  
  554.  
  555.       MS-DOS DATE and TIME Commands:
  556.  
  557.           Most PC systems automatically set the hardware clock date and
  558.           time (which is maintained while the system is turned off, and is
  559.           different from the DOS date and time) when the corresponding DOS
  560.           command is executed.  In most such cases the hardware manufactur-
  561.           er has implemented this capability within the BIOS built into the
  562.           system.  This type of implementation is compatible with 4DOS, and
  563.           the 4DOS DATE and TIME commands will set the hardware clock prop-
  564.           erly.
  565.  
  566.           A very small number of manufacturers have modified the version
  567.           COMMAND.COM which they sell with their PCs to perform this func-
  568.           tion.  In these cases, 4DOS's DATE and TIME commands, which do
  569.           not have such hardware-specific modifications, will not set the
  570.           hardware clock.  If you normally set the hardware clock's date
  571.           and time with DOS commands, and they don't work under 4DOS, first
  572.           check your clock's battery!  If it's OK, either run a secondary
  573.           copy of COMMAND.COM to set the date and time, or invoke your
  574.           system's SETUP or other utility program to do so.
  575.  
  576.  
  577.  
  578.  
  579.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 10
  580.  
  581.  
  582.       MS-DOS FASTOPEN Command:
  583.  
  584.           The MS-DOS FASTOPEN command generally works with 4DOS, but does
  585.           not properly detect renamed directories, and may have similar
  586.           problems when directories are removed.  This is a problem in
  587.           FASTOPEN, not in 4DOS.  If you use FASTOPEN and rename a direc-
  588.           tory with the 4DOS REN command, then do a DIR command, you may
  589.           see the old name and not the new one displayed; you may also
  590.           occasionally have trouble accessing files under the new name. 
  591.           The only solution we are aware of in this situation is to reboot
  592.           your system.
  593.  
  594.           Our opinion is that, if you have the memory to support it, a disk
  595.           caching program will provide a much greater and more effective
  596.           performance improvement than FASTOPEN.
  597.  
  598.  
  599.       MS-DOS 4.0 and 5.0 FORMAT /S Command:
  600.  
  601.           The FORMAT /S command in DOS 4 and DOS 5 will copy 4DOS.COM to a
  602.           newly formatted floppy disk and rename it COMMAND.COM, which may
  603.           not be what you want and is confusing at best.  See the discus-
  604.           sion of "4DOS and DOS" in Chapter 7 of the manual for more infor-
  605.           mation on this issue.
  606.  
  607.  
  608.       MS-DOS 4.0+ SELECT Command:
  609.  
  610.           In MS-DOS 4.0 and above a SELECT command was introduced.  This
  611.           external command is totally unrelated to the 4DOS internal SELECT
  612.           command.  If you need to use both, you can set up aliases to
  613.           adjust how the command names are handled.  For example, the fol-
  614.           lowing two aliases set up SELECT to access the DOS 4.0 external
  615.           SELECT command (assumed to be stored in C:\DOS\SELECT.EXE), and
  616.           SEL to access the internal 4DOS SELECT command:
  617.  
  618.                     alias select c:\dos\select.exe
  619.                     alias sel *select
  620.  
  621.  
  622.       1DIR+ (Bourbaki):
  623.  
  624.           The information below was obtained from tests with 1DIR+ version
  625.           3.02, and verified with version 3.5 as well.
  626.  
  627.           1DIR+ will work properly under 4DOS in its partially resident or
  628.           EMS modes when set up as described below.  It will work in its
  629.           fully resident mode but cannot reliably exit back to 4DOS once
  630.           started.
  631.  
  632.           If your copy of 1DIR+ is set up for fully resident mode, you can
  633.           load it into memory under 4DOS to switch it to partially resident
  634.  
  635.  
  636.  
  637.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 11
  638.  
  639.  
  640.           or EMS mode.  To do so, from the directory where you normally run
  641.           1DIR+, type the commands:
  642.  
  643.                     setdos /l1
  644.                     1dirplus
  645.  
  646.           When 1DIR+ starts go to the "Wonder" / "Setup" menu and switch
  647.           the mode to partially resident or EMS.  Hit Esc to exit, and take
  648.           the "Exit/Save" option (not "Save/Reset").  Back at the main
  649.           menu, exit with "Wonder" / "Exit".  At this point the system will
  650.           probably hang.  Reboot your computer.  You should then be able to
  651.           run 1DIR+ as described below.
  652.  
  653.           The above steps only need to be done once, when you install or
  654.           re-install 1DIR+.
  655.  
  656.           Once 1DIR+ is set to EMS or partially-resident mode, you can
  657.           start it from 4DOS using the following alias:
  658.  
  659.                     alias 1dir `setdos /L1 ^ 1dirplus`
  660.  
  661.           The SETDOS /L1 is necessary to allow 1DIR+ to send command lines
  662.           to 4DOS.
  663.  
  664.           You must do a SETDOS /L0 when you are done with 1DIR+ in order to
  665.           get normal 4DOS command-line editing back.  You can NOT do this
  666.           within the alias above, as 1DIR+ returns to 4DOS in order to
  667.           accomplish its work, and you don't want to switch back to /L0
  668.           mode until 1DIRPLUS has been removed from memory.  If, after
  669.           exiting from 1DIR+, you find that 4DOS's command line editing and
  670.           history are unavailable, it is because you forgot to do the
  671.           SETDOS /L0.  If you go in and out of 1DIR+ regularly aliases like
  672.           the following can be used to make the process quick:
  673.  
  674.                     alias 1d `setdos /L1 ^ 1dirplus`
  675.                     alias 1e setdos /L0
  676.  
  677.  
  678.       ANSI.SYS (various manufacturers):
  679.  
  680.           If you have trouble with screen scrolling in 43-line or 50-line
  681.           mode, try a different version of ANSI.  We have had good results
  682.           with PC Magazine's free utility ANSI.COM, and with the ANSI-
  683.           UV.SYS program distributed with Personics' UltraVision EGA / VGA
  684.           enhancement software.
  685.  
  686.  
  687.       Bookshelf CD-ROM (Microsoft):  [**]
  688.  
  689.           Microsoft Bookshelf uses the environment variable CDPATH, which
  690.           is also used (for a totally different purpose) by 4DOS.  If you
  691.           are using MS Bookshelf and want to set a CDPATH variable for
  692.  
  693.  
  694.  
  695.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 12
  696.  
  697.  
  698.           4DOS, set _CDPATH instead.  4DOS will search for _CDPATH first;
  699.           when it is found, 4DOS will use it, and ignore CDPATH.
  700.  
  701.  
  702.       DESQView (Quarterdeck):
  703.  
  704.           Most information about DESQView is in chapter 7 of the manual.
  705.  
  706.           Under 4DOS, the DESQView DOS Services option will not work in its
  707.           default configuration.  To make DOS Services work under 4DOS, you
  708.           must first create a batch file, DOSSERV.BAT, in your DESQView
  709.           directory to run DOS Services under COMMAND.COM.  (We are assum-
  710.           ing that DESQView is in directory C:\DV and COMMAND.COM is in
  711.           directory C:\; you will need to modify the settings below if your
  712.           system is configured differently.)  The batch file is:
  713.  
  714.                     set comspec=c:\command.com
  715.                     c:\dv\dosserv
  716.                     c:\command
  717.                     exit
  718.  
  719.           Then, make the following changes on the DESQView change a program
  720.           screen for DOS Services (items marked ** are on the second page
  721.           of the screen):
  722.  
  723.                     *   Memory Allocation = 128K or greater
  724.                     *   Program Name = C:\DV\DOSSERV.BAT (modify from
  725.                         previous value of C:\DV\DOSSERV).
  726.                     **  Close on Exit to DOS = N
  727.                     **  System Memory = 10K or greater
  728.                     **  Allow Close Window = N
  729.  
  730.           Once these steps are taken, you should be able to open the DOS
  731.           Services window normally.  However you will not be able to close
  732.           it with a close window command.  Instead, go to the window where
  733.           DOS Services allows you to compose a DOS command, and type EXIT
  734.           to close the window.
  735.  
  736.  
  737.       DR-DOS (Digital Research):
  738.  
  739.           4DOS will work properly as a command processor (including as the
  740.           primary shell) under DR-DOS 3.4, 5.0, or 6.0.  The information
  741.           below was developed by testing 4DOS under DR-DOS 5.0 and 6.0.
  742.  
  743.           Internal vs. External Commands:
  744.  
  745.               DR-DOS 5.0's design makes the ASSIGN, JOIN, MORE, and SUBST
  746.               commands internal (in MS-DOS / PC-DOS they are external). 
  747.               4DOS supports all MS-DOS internal commands, but does not have
  748.               internal support for ASSIGN, JOIN, MORE, and SUBST.  To ac-
  749.               cess these DR-DOS internal commands when using 4DOS as the
  750.  
  751.  
  752.  
  753.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 13
  754.  
  755.  
  756.               command processor, you must set up aliases which run DR-DOS's
  757.               COMMAND.COM.  The following 4DOS aliases accomplish this
  758.               (adjust these if COMMAND.COM is not in C:\):
  759.  
  760.                     alias assign `c:\command /c assign %&`
  761.                     alias join `c:\command /c join %&`
  762.                     alias more `c:\command /c more %&`
  763.                     alias subst `c:\command /c subst %&`
  764.  
  765.               In DR-DOS 6.0 ASSIGN, JOIN, and SUBST were changed back to
  766.               external commands, so the corresponding aliases are not nec-
  767.               essary.
  768.  
  769.               For the MORE command, a much better alternative can be set up
  770.               by aliasing it to the 4DOS LIST command:
  771.  
  772.                     alias more list /s
  773.  
  774.               This provides a scrollable, full-screen display rather than
  775.               the simple paged display offered by DR-DOS (or MS-DOS) MORE.
  776.  
  777.           HILOAD:
  778.  
  779.               4DOS supports DR-DOS's HILOAD feature using the MS-DOS / PC-
  780.               DOS command names of LOADHIGH or LH.  To load a TSR high
  781.               under DR-DOS, simply use the command:
  782.  
  783.                     LH [programname] [options]
  784.  
  785.               If you want the command to be called HILOAD for complete DR-
  786.               DOS compatibility, just set up an alias before using it:
  787.  
  788.                     alias hiload lh
  789.  
  790.               Just as under MS-DOS, LOADHIGH and LH will not work properly
  791.               unless you have memory management software loaded to provide
  792.               upper memory block support.  Because DR-DOS does not return
  793.               any error to 4DOS if a LOADHIGH operation fails, 4DOS cannot
  794.               report this condition to you.  This means you must use the
  795.               DR-DOS MEM program or another similar memory mapping utility
  796.               to determine if your TSR was actually loaded high.
  797.  
  798.           File Passwords:
  799.  
  800.               4DOS includes support for DR-DOS file passwords.  However the
  801.               command syntax used to access files with passwords is slight-
  802.               ly different than under DR-DOS.
  803.  
  804.               First, the character used to separate passwords from file-
  805.               names under DR-DOS is a semicolon [;], which 4DOS uses to
  806.               separate parts of an "include list" (see the manual for de-
  807.               tails).  Therefore, a slightly different syntax must be used
  808.  
  809.  
  810.  
  811.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 14
  812.  
  813.  
  814.               when including a DR-DOS password in a 4DOS internal command
  815.               which accepts wildcards:  TWO semicolons should be used to
  816.               separate the password and filename.  4DOS directory-related
  817.               commands like MD and CD do not use wildcards and therefore a
  818.               single semicolon should be used before a password in these
  819.               commands.  All other 4DOS commands which accept wildcards
  820.               must use the double semicolon.  DR-DOS external commands
  821.               which accept the "password;filename" syntax will still use
  822.               only a single semicolon.
  823.  
  824.               Second, DR-DOS hides files which are password-protected. 
  825.               This means that you must use 4DOS command switches which
  826.               allow processing of hidden files (COPY /H, DEL /Z, DIR /A,
  827.               MOVE /H, and SELECT /A) to access a password-protected file
  828.               under DR-DOS.
  829.  
  830.               Passwords are not automatically preserved when copying or
  831.               moving a file with 4DOS.  However the hidden attribute will
  832.               be preserved.  This means that if you move or copy a pass-
  833.               worded file and want it to be visible in its new location or
  834.               under its new name, you will have to manually remove the
  835.               hidden attribute with ATTRIB.
  836.  
  837.               For example, to password-protect the file JUNK, copy it to
  838.               drive A:, and then delete it:
  839.  
  840.                     password junk /r:fred
  841.                     copy /h junk;;fred a:
  842.                     del /z junk;;fred
  843.  
  844.               To unprotect the password-protected file JUNK:
  845.  
  846.                     password junk;fred /n
  847.  
  848.           TASKMAX:
  849.  
  850.               4DOS will work with TASKMAX as long as you start new tasks
  851.               according to the instructions below.
  852.  
  853.               You cannot load 4DOS's resident portion high with UMBLoad =
  854.               Yes in your 4DOS.INI file when running TASKMAX.  TASKMAX will
  855.               hang the system if it is started while 4DOS is loaded high. 
  856.               In our tests we have found that the same restriction does not
  857.               apply to the UMBEnvironment directive, which does appear to
  858.               be compatible with TASKMAX.
  859.  
  860.               When TASKMAX is loaded it leaves the primary command proces-
  861.               sor running as task 1.  One way to start another task is to
  862.               pop up TASKMAX and press Ins.  This starts another "instance"
  863.               of the primary command processor, and may cause significant
  864.               problems with 4DOS.  The reason is that each task started in
  865.               this way is a copy of the primary command processor, so all
  866.  
  867.  
  868.  
  869.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 15
  870.  
  871.  
  872.               such tasks will use the same swap area.  This will make chan-
  873.               ges to things like aliases, history, and SETDOS settings in
  874.               one task "bleed through" to other tasks.  The exact nature of
  875.               the bleed-through will depend on the sequence of operations
  876.               and the type of 4DOS swapping you use.  This bleed-through
  877.               will not necessarily hang your system but it may lead to very
  878.               strange and undesired results, especially when running batch
  879.               files simultaneously in more than one task.  There is no way
  880.               for 4DOS to detect or prevent this condition.  We strongly
  881.               recommend that you do NOT use Ins to start new 4DOS tasks,
  882.               even if it temporarily appears to work properly on your
  883.               system.
  884.  
  885.               Fortunately TASKMAX offers another way to start new tasks: 
  886.               the TASKMAX /C command.  When executed from task 1, a command
  887.               like:
  888.  
  889.                     taskmax /c c:\4dos.com
  890.  
  891.               will start a new secondary copy of 4DOS as a new task.  This
  892.               new copy is a true secondary shell (not a copy of the primary
  893.               shell) and will not cause the undesirable interactions de-
  894.               scribed above.  The same approach should be used when start-
  895.               ing any task which needs a command processor.  To start a
  896.               task which runs a .BTM or .BAT file, use a command like this:
  897.  
  898.                     taskmax /c c:\4dos.com /c startwp.bat
  899.  
  900.               This tells 4DOS to run the specified batch file, and exit
  901.               automatically (removing the task from the task list) when the
  902.               batch file is done.
  903.  
  904.               If you have tasks you start regularly using the approach
  905.               described above, use a batch file or a set of 4DOS aliases to
  906.               help automate the process.
  907.  
  908.  
  909.       Epsilon (Lugaru Software):  [**]
  910.  
  911.           Epsilon can run 4DOS as a concurrent process, and pass commands
  912.           to 4DOS for execution.  In this mode it traps 4DOS's input re-
  913.           quests and feeds the keystrokes to 4DOS.  However it does not
  914.           feed backspaces etc. -- only actual characters.  This means that
  915.           editing of input isn't seen by 4DOS.  To fix the problem, either
  916.           run 4DOS as a shell, and not as a concurrent process, or use a
  917.           SETDOS /L1 for the copy of 4DOS that is run under Epsilon.  
  918.  
  919.           To use the more flexible SETDOS /L1 approach you must use
  920.           4START.BAT (or .BTM) to set up the SETDOS /L1 before running
  921.           Epsilon.  To do so, first set up an alias for Epsilon that sets
  922.           an environment variable (change the name of the variable if you
  923.           wish):
  924.  
  925.  
  926.  
  927.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 16
  928.  
  929.  
  930.                     alias eps `set epsi=YES^epsilon %&^unset epsi`
  931.  
  932.           Then placing the following line in 4START will issue the SETDOS
  933.           /L1 command in a secondary shell started by Epsilon, but ignore
  934.           it otherwise:
  935.  
  936.                     if "%epsi"=="YES" setdos /l1
  937.  
  938.  
  939.       GeoWorks Ensemble (GEOS):
  940.  
  941.           4DOS is compatible with GeoWorks Ensemble.  To run aliases or BTM
  942.           files from the DOS Programs screen, you must setup a new program
  943.           button with 4DOS.COM as the "primary file name" and your alias or
  944.           BTM as the "optional command line parameters".  Commands can be
  945.           entered the same as on the DOS command line.  A longer file of
  946.           user-written tips for using 4DOS with GeoWorks is available in JP
  947.           Software's CompuServe support area (PCVENB library 10) as
  948.           GEOTIP.ZIP.  This file includes information on using the undocu-
  949.           mented GeoWorks "dosAssociations" and "dosParameters" directives
  950.           to create an even smoother interface between GeoWorks and 4DOS.
  951.  
  952.  
  953.       Hijaak (Inset Systems):
  954.  
  955.           The Resident Program Manager (RPM) cannot be loaded from Hijaak's
  956.           menu when 4DOS is the command processor.  If you try to load RPM
  957.           from the menu you will receive "Out of memory" errors once it is
  958.           loaded.  This is due to the internal design of Hijaak and is not
  959.           a 4DOS bug.  To work around this problem, use the LOADRPM command
  960.           from the 4DOS prompt, as described in the Hijaak manual.  LOADRPM
  961.           will load RPM with no trouble under 4DOS, the problem occurs when
  962.           loading from the Hijaak menu only.
  963.  
  964.  
  965.       LOGIMENU (Logitech):  [**]
  966.  
  967.           If Logitech's LOGIMENU is loaded from a hard disk when running
  968.           with 4DOS, it leaves a file open each time a menu is unloaded. 
  969.           To work around this problem, load the menu from a floppy disk or
  970.           RAM disk.
  971.  
  972.  
  973.       Manifest (Quarterdeck):
  974.  
  975.           Manifest generally works well with 4DOS.  However if there is too
  976.           little environment space free in 4DOS's master environment, the
  977.           Hints Detail screen in Manifest may give unexpected results or
  978.           hang your system.  If this occurs, increase your environment size
  979.           and / or remove some environment variables when starting Manifest
  980.           if you plan to use the Hints Detail screen.
  981.  
  982.  
  983.  
  984.  
  985.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 17
  986.  
  987.  
  988.       MOVE-EM (Qualitas):  [**]
  989.  
  990.           MOVE-EM is compatible with 4DOS's UMBLoad and UMBEnvironment
  991.           directives as long as Microsoft's HIMEM.SYS is also loaded in
  992.           your system.  MOVE-EM itself does not fully support the XMS spec-
  993.           ification which permits 4DOS to load itself and the master envi-
  994.           ronment in high memory.
  995.  
  996.  
  997.  
  998.       Netware (Novell):  [**]
  999.  
  1000.           The information below was obtained from tests with Netware ver-
  1001.           sions 2.12, 2.15, and 3.11 - 3.2, and Netware 386, and from dis-
  1002.           cussions with Novell support personnel.
  1003.  
  1004.           Compatibility problems between Netware and 4DOS should be quite
  1005.           rare.  When they do occur, the usual problem is a conflict be-
  1006.           tween 4DOS and the Netware shell (NET3, NET4, NET5, NETX,
  1007.           EMSNETX, etc.).  As a general rule, you should find that Novell's
  1008.           newer "NETX" shell versions have considerably fewer problems than
  1009.           the older NET3 / NET4 / NET5 versions, and we recommend their use
  1010.           with 4DOS whenever possible.
  1011.  
  1012.           Some versions of Netware may occasionally produce a "pipe not
  1013.           found" message when loading under 4DOS.  This message refers to
  1014.           Netware features related to COMMAND.COM, and does not apply to
  1015.           4DOS; the message can be ignored.
  1016.  
  1017.           The 4DOS TRUENAME command and the @TRUENAME variable function
  1018.           will return true Netware server names when given a file name that
  1019.           refers to a Netware drive.  However the returned name will not be
  1020.           correct if only the root directory name is given as a parameter
  1021.           (for example TRUENAME K:\).  This is because Netware fails to
  1022.           recognize the true name request properly when only a root direc-
  1023.           tory name is given; it is not a bug in 4DOS.  If necessary, you
  1024.           can work around this problem by adding a simple "." to the re-
  1025.           quest (TRUENAME K:\.).
  1026.  
  1027.           If you use 4DOS input redirection in a .BAT file which resides on
  1028.           a Netware drive, you may experience incorrect file assignments on
  1029.           some systems.  When this occurs, an application run from within
  1030.           the batch file, or a secondary shell run from such an applica-
  1031.           tion, may loop forever attempting to read lines from the batch
  1032.           file rather than accepting input from the keyboard.  For example:
  1033.  
  1034.                     copy /r *.* g: < YES
  1035.                     wp
  1036.                     rem  Now if the user shells from WP, the system will
  1037.                     rem  loop forever reading lines from the batch file or
  1038.                     rem  blank lines at the prompt.
  1039.  
  1040.  
  1041.  
  1042.  
  1043.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 18
  1044.  
  1045.  
  1046.           This problem occurs because Netware does not handle file assign-
  1047.           ments properly when 4DOS input redirection is used in a .BAT
  1048.           file.  We are working with Novell to attempt to resolve the prob-
  1049.           lem.  You can work around it in several ways:
  1050.  
  1051.               * Change the batch file to a .BTM file.
  1052.  
  1053.               * Place the file BTM mode with the LOADBTM command at any
  1054.               point prior to the use of input redirection.
  1055.  
  1056.               * Move the file to a non-Netware drive.
  1057.  
  1058.               * User reports indicate that adding a line which does a "dum-
  1059.               my" output redirection just before the input redirection will
  1060.               prevent the problem from occurring.  For example:
  1061.  
  1062.                     echo This is junk > junk.dat
  1063.                     copy /r *.* g: < YES
  1064.                     wp
  1065.                     del junk.dat
  1066.  
  1067.           When loading a secondary 4DOS shell under Netware you can swap
  1068.           the shell to a network drive if you configure 4DOS properly.  To
  1069.           do so you must take into account the fact that Netware closes all
  1070.           files -- including the 4DOS swap file -- each time an application
  1071.           exits.  Under the default 4DOS configuration, the next time 4DOS
  1072.           uses the swap file, a swap file seek error will occur.  However
  1073.           if you set SwapReopen = Yes in 4DOS.INI, 4DOS will reopen its
  1074.           swap file each time such an error occurs, and the swapping will
  1075.           work.  See the manual for details on SwapReopen.  You can also
  1076.           avoid this problem by swapping to EMS, XMS, or a local hard disk
  1077.           or RAM disk.
  1078.  
  1079.           Use caution with the 4DOS UNSET command under Netware.  When Net-
  1080.           ware is loaded it remembers the exact location of the COMSPEC
  1081.           variable in the master environment, and it may therefore have
  1082.           problems if variables such as COMSPEC and PATH are removed and
  1083.           reloaded in a different sequence.
  1084.  
  1085.           The UMBLoad directive in 4DOS.INI is compatible with Netware. 
  1086.           The UMBEnvironment directive is compatible with Netware 3.11 and
  1087.           above, but not with earlier versions.
  1088.  
  1089.           Netware versions prior to 3.11 have a bug which can destroy one
  1090.           or more characters in the name of an environment variable (usual-
  1091.           ly the second or third one in the environment) when setting other
  1092.           environment variables from inside a LOGIN script.  If you are
  1093.           setting environment variables such as COMSPEC within your LOGIN
  1094.           script, you can get around this problem by using a batch file to
  1095.           set the variables after LOGIN is complete.  Even if you cannot
  1096.           control the LOGIN script, you can still use a batch file to reset
  1097.           the "damaged" variables after LOGIN has finished.  One user has
  1098.  
  1099.  
  1100.  
  1101.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 19
  1102.  
  1103.  
  1104.           successfully worked around this problem by installing several
  1105.           "dummy" variables at the very beginning of AUTOEXEC, for example:
  1106.  
  1107.                     set a=a
  1108.                     set aa=aa
  1109.                     set aaa=aaa
  1110.  
  1111.           When these are installed it is the "dummy" variables which are
  1112.           damaged rather than the meaningful variables (PATH, PROMPT, etc.)
  1113.           which are defined later.  This bug is fixed in Netware 3.11 and
  1114.           later versions.
  1115.  
  1116.  
  1117.       Novell MENU (Novell):
  1118.  
  1119.           The Novell MENU system distributed with Netware uses Interrupt 2E
  1120.           to execute menu options, and therefore requires the use of the
  1121.           FullINT2E = Yes directive in 4DOS.INI.  Once INT 2E support is
  1122.           enabled with this directive, Novell MENU should work normally
  1123.           under 4DOS.
  1124.  
  1125.  
  1126.       OS/2 1.3 and 2.0 (IBM):
  1127.  
  1128.           4DOS works properly as the shell in your OS/2 DOS box (version
  1129.           1.3) or DOS machines (version 2.0).  When installing OS/2 version
  1130.           1.3's dual boot option you may receive a warning because your
  1131.           SHELL command in CONFIG.SYS points to 4DOS rather than
  1132.           COMMAND.COM.  In our experience this warning can be ignored, and
  1133.           OS/2 will install properly.
  1134.  
  1135.           If you experience problems running 4DOS in a DOS machine under
  1136.           beta versions of OS/2 2.0, please contact us for assistance. 
  1137.           While 4DOS 4.0 does run properly in OS/2 2.0 DOS machines as of
  1138.           the 4DOS 4.0 release date, changes to OS/2 during the version 2.0
  1139.           beta program may require minor changes in 4DOS.  These will be
  1140.           addressed in 4DOS maintenance releases as necessary.
  1141.  
  1142.  
  1143.       PC Tools (Central Point Software):  [**]
  1144.  
  1145.           The timed execution function in the PC Tools version 7 DESKTOP
  1146.           program does not work with 4DOS if DESKTOP is loaded directly. 
  1147.           However if SWAPDT (distributed with PC Tools) is used to load
  1148.           DESKTOP, timed execution will work with 4DOS.
  1149.  
  1150.  
  1151.       Personal REXX (Quercus Systems):  [**]
  1152.  
  1153.           Personal REXX generally works well with 4DOS.  However there are
  1154.           some issues you must take into account when using certain person-
  1155.           al REXX features.
  1156.  
  1157.  
  1158.  
  1159.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 20
  1160.  
  1161.  
  1162.           The Personal REXX Batch Manager will not work with 4DOS as the
  1163.           command processor.  The Batch Manager allows REXX programs to be
  1164.           executed from the command line without requiring a REXX or RX
  1165.           command prefix.  The Batch Manager accomplishes this by using an
  1166.           undocumented feature of COMMAND.COM, and Mansfield Software
  1167.           states that this may not work on OEM versions of DOS, and advises
  1168.           that if it does not work, don't use it.  To work around this
  1169.           problem, use executable extensions to tell 4DOS to execute .REX
  1170.           files using REXX.EXE.  To set this up, add a command like this to
  1171.           your AUTOEXEC.BAT file:
  1172.  
  1173.                     set .rex=d:\path\rexx.exe
  1174.  
  1175.           where "d:\path" is the drive and directory where REXX.EXE is
  1176.           stored.  Once this executable extension is set up, REXX programs
  1177.           will run as though the Batch Manager was installed.  Note, howev-
  1178.           er, that the Batch Manager would attempt the execution of REXX
  1179.           programs before .BAT files, whereas 4DOS executable extensions
  1180.           are executed after .BTM and .BAT files.
  1181.  
  1182.           Personal REXX also provides the ADDRESS DOS statement, which
  1183.           allows the REXX program to pass commands to the DOS command pro-
  1184.           cessor.  This function is implemented through the undocumented
  1185.           INT 2E interface to the command processor, which can be enabled
  1186.           in 4DOS with the FullINT2E=Yes directive in 4DOS.INI.  If you use
  1187.           FullINT2E=Yes and have trouble with ADDRESS DOS, use Personal
  1188.           REXX's OPTIONS NEWCOM, or an environment variable, SET
  1189.           RXNEWCOM=YES, to force ADDRESS DOS to shell to a new copy of
  1190.           4DOS.  Note that the normal Personal REXX ADDRESS DOS function
  1191.           permits the environment to be permanently modified, whereas using
  1192.           OPTIONS NEWCOM, or setting the environment variable will not
  1193.           permit this.  Quercus Systems discourages the use of the INT 2E
  1194.           approach in DOS 4.00 or later, and Personal REXX will default to
  1195.           not using INT 2E with these versions of DOS.
  1196.  
  1197.  
  1198.       QEMM and QRAM (Quarterdeck):
  1199.  
  1200.           The information below was obtained from tests with QEMM versions
  1201.           5 and 6, and user reports on QRAM.
  1202.  
  1203.           Both QEMM (including the QEMM 6 STEALTH mode) and QRAM are com-
  1204.           patible with 4DOS, and will allow you to load the 4DOS resident
  1205.           code and the master environment into high DOS memory (UMBs) via
  1206.           the UMBLoad and UMBEnvironment directives in 4DOS.INI.  For these
  1207.           directives to work with QRAM you must have QEXT loaded also (this
  1208.           is the normal method of loading QRAM).
  1209.  
  1210.           QEMM allocates both XMS and EMS memory from the same memory area. 
  1211.           Therefore it always reports the exact same amount of free XMS and
  1212.           EMS memory.  You will see this in the free EMS and free XMS val-
  1213.           ues displayed by the 4DOS MEMORY command -- they will be exactly
  1214.  
  1215.  
  1216.  
  1217.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 21
  1218.  
  1219.  
  1220.           the same under QEMM.  Just remember that if both values are (say)
  1221.           512K, that means you have 512K of free memory which can be allo-
  1222.           cated either way -- not 1024K!
  1223.  
  1224.           If you use FILES.COM to load part of the DOS file handle table
  1225.           into high memory, you must follow Quarterdeck's recommendations
  1226.           and keep a minimum of FILES=8 in CONFIG.SYS.  Lower values may
  1227.           cause 4DOS to hang during boot, especially if disk swapping is
  1228.           used.
  1229.  
  1230.           If you use QEMM's OPTIMIZE and your AUTOEXEC has 4DOS-specific
  1231.           commands like GLOBAL, IFF, aliases, etc., OPTIMIZE will recognize
  1232.           them based on the 4DOS.CMD file distributed with QEMM 6.  Note
  1233.           that in QEMM version 6.00 this file is incomplete in that it does
  1234.           not include the ELSE, ELSEIFF, and ENDIFF commands; you should
  1235.           add these commands to 4DOS.CMD if you use them in your AUTOEXEC
  1236.           file.  This error in 4DOS.CMD was corrected in version 6.01 of
  1237.           QEMM.  To use 4DOS.CMD it must be renamed to OPTIMIZE.EXC before
  1238.           running OPTIMIZE; see your QEMM documentation for details.  Also
  1239.           note that OPTIMIZE cannot take account of the fact that 4DOS may
  1240.           be loaded high with UMBLoad = Yes in 4DOS.INI, and therefore may
  1241.           not give the best optimization results when UMBLoad = Yes is used
  1242.           (OPTIMIZE has this problem with all programs which load them-
  1243.           selves into UMBs, not just with 4DOS).
  1244.  
  1245.  
  1246.       SigmaPlot (Sigma Designs):  [**]
  1247.  
  1248.           The batch file PLOT.BAT used to start some versions of SigmaPlot
  1249.           uses an outdated method of determining DOS version which will
  1250.           fail under 4DOS, reporting that "SigmaPlot requires DOS 2.0 or
  1251.           later".  You can fix this batch file easily.  At the beginning of
  1252.           the file, look for the group of lines which reads:
  1253.  
  1254.               dosver
  1255.               for %%v in (1,2,3,4) do if errorlevel %%v goto DosVer%%v
  1256.               echo Error! Can't determine DOS version.
  1257.  
  1258.           Replace these three lines with the following single line:
  1259.  
  1260.               goto DosVerX
  1261.  
  1262.           where "X" is the version of DOS you are running (i.e. DosVer3,
  1263.           DosVer4, etc.).
  1264.  
  1265.  
  1266.       Software Carousel (SoftLogic Solutions):
  1267.  
  1268.           Please see the general section on multitaskers in chapter 7 of
  1269.           the manual before reading this section.
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 22
  1276.  
  1277.  
  1278.           The information below was obtained from tests with Software Car-
  1279.           ousel version 3, and discussions with SoftLogic technical sup-
  1280.           port.  It applies to all versions of Software Carousel.
  1281.  
  1282.           Software Carousel will not work properly with 4DOS loaded as the
  1283.           primary shell.  It is designed with the assumption that
  1284.           COMMAND.COM is the system command processor, and contains logic
  1285.           which specifically depends on COMMAND.COM and the way it is writ-
  1286.           ten, and which actually modifies the copy of COMMAND.COM in memo-
  1287.           ry.  This makes it impossible to write a program which works
  1288.           properly as an alternate command processor loaded underneath
  1289.           (i.e. before) Software Carousel.
  1290.  
  1291.           However, 4DOS can be run without difficulty inside a Software
  1292.           Carousel partition, if the instructions below are followed.
  1293.  
  1294.           When loading 4DOS into a Carousel partition, the best method is
  1295.           to leave the COMSPEC set to COMMAND.COM when Carousel is loaded. 
  1296.           4DOS should then be set up in the Carousel options file just like
  1297.           any other program.  For example, to load 4DOS into partition 1:
  1298.  
  1299.                     d:\path\4DOS.COM [parameters] [filename]
  1300.  
  1301.           where:
  1302.  
  1303.               d:\path         is the drive and path where 4DOS.COM is lo-
  1304.                               cated
  1305.  
  1306.               [parameters]    is any 4DOS command line parameters (/E,
  1307.                               @ininame, etc.; do NOT use /P here)
  1308.  
  1309.               [filename]      is the name of a batch file to be executed
  1310.                               when the partition is started
  1311.  
  1312.           To use different 4DOS.INI files for different Software Carousel
  1313.           partitions, use the "@ininame" parameter in the "parameters"
  1314.           section of your Carousel setup to invoke a specific file.  For
  1315.           example, the parameters could be set to @D:\WP\4DOSWP.INI to use
  1316.           that initialization file for the WP partition.
  1317.  
  1318.           Because 4DOS can only be loaded in a partition when running Soft-
  1319.           ware Carousel, and not as the primary command processor, using
  1320.           4DOS disk swapping in multiple partitions is subject to the cau-
  1321.           tionary note on this subject in the general information section
  1322.           on multitaskers in the manual; please read it carefully.
  1323.  
  1324.  
  1325.       TSRCOM Utilities (TurboPower Software):
  1326.  
  1327.           The TSRCOM utilities will work properly with 4DOS as long as you
  1328.           use TSRCOM version 2.6 or later.  The current release is version
  1329.  
  1330.  
  1331.  
  1332.  
  1333.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 23
  1334.  
  1335.  
  1336.           3.0, and is available on the 4DOS Utility Disk and on many bulle-
  1337.           tin boards and on-line systems.
  1338.  
  1339.           If you use TSRCOM's MARK and RELEASE to manage your TSRs, 4DOS
  1340.           swapping (as set with the SWAPPING command) must be in the same
  1341.           state when RELEASE is run as it was when MARK (or FMARK) was run. 
  1342.           This is a characteristic of the design of MARK and RELEASE (or
  1343.           any other such products), and not a bug.  If you do not observe
  1344.           this rule (for example, if you run MARK with SWAPPING OFF in
  1345.           AUTOEXEC and later run RELEASE from the prompt with SWAPPING ON),
  1346.           you may receive unusual error messages or hang your system.  The
  1347.           same restriction applies to MARKNET and RELNET.
  1348.  
  1349.  
  1350.       UltraVision (Personics):
  1351.  
  1352.           The DE program distributed with UltraVision is written specifi-
  1353.           cally for COMMAND.COM, and cannot be used to set directory colors
  1354.           with 4DOS.  Use 4DOS's built-in directory colorization instead.
  1355.  
  1356.  
  1357.       Ventura Publisher (Xerox):  [**]
  1358.  
  1359.           Ventura Publisher version 2.0 has a bug which prevents it from
  1360.           working properly if more than about 256 bytes of environment
  1361.           space are in use.  If necessary, you can write a small batch file
  1362.           to reduce environment space in use while Ventura Publisher is
  1363.           running.  See the section headed "Solving Software Compatibility
  1364.           Problems" in chapter 7 of the manual for information on creating
  1365.           this kind of batch file.
  1366.  
  1367.  
  1368.       Windows 3.0 (Microsoft):
  1369.  
  1370.           Most information about Windows 3.0 is in chapter 7 of the manual. 
  1371.           See the section on PATH problems earlier in this file for one
  1372.           caution related to the Setup Applications program.
  1373.  
  1374.  
  1375.       Programs Requiring PATH to be Under 128 Characters:
  1376.  
  1377.           The following programs contain bugs which prevent them from work-
  1378.           ing properly if you have a PATH which is over 128 characters
  1379.           long.  Since 4DOS allows you to create a PATH up to 255 charac-
  1380.           ters long this can appear to be a conflict between the program
  1381.           involved and 4DOS.  If your path is longer than 128 characters,
  1382.           see the section headed "Solving Software Compatibility Problems"
  1383.           in chapter 7 of the manual for information on creating a batch
  1384.           file to reduce the PATH length while one of these programs is
  1385.           running.
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 24
  1392.  
  1393.  
  1394.               Computer Select CD-ROM Database (Ziff-Davis):  [**]  Computer
  1395.               Select cannot find its help program if your PATH is over 128
  1396.               characters long.  
  1397.  
  1398.               RenderMan (AutoDesk):  RenderMan will hang your system if it
  1399.               is started with a PATH longer than 128 characters.
  1400.  
  1401.               VINES Network (Banyan):  [**]  VINES' installation may not
  1402.               work properly if your PATH is longer than 128 characters.
  1403.  
  1404.               Windows 3.0 (Microsoft):  The Windows 3 Setup Applications
  1405.               option, which scans your disk drives for applications to be
  1406.               added to Windows program groups, will not work properly if
  1407.               your PATH is more than 128 characters long.
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 25
  1450.  
  1451.  
  1452.  
  1453.    Software For Use With 4DOS
  1454.    --------------------------
  1455.  
  1456.    We receive many requests for recommendations on software that works well
  1457.    with 4DOS, or that we have found especially useful.
  1458.  
  1459.    While we can't recommend what will work well on your system or to meet
  1460.    your needs, we can tell you what packages we have used and found valu-
  1461.    able.  We will confine our comments to our primary area of expertise --
  1462.    system software -- and avoid discussing applications programs like
  1463.    spreadsheets and word processors.
  1464.  
  1465.    Please note that this is NOT actually a list of what works well with
  1466.    4DOS -- the answer to that is, almost everything!  And remember this is
  1467.    only our opinions -- you need to choose what will work best for you.
  1468.  
  1469.       Memory Managers:  We generally use 386MAX and BlueMax (Qualitas) on
  1470.       our own systems because we find it offers some important technical
  1471.       advantages.  Many 4DOS users also report excellent results with QEMM
  1472.       (Quarterdeck), and we use it at times as well.  We have less experi-
  1473.       ence with other memory managers like Netroom (Helix) and Memory Com-
  1474.       mander (V Communications), so we can't comment on them.
  1475.  
  1476.       Task Switchers:  For switching between applications which run one at
  1477.       a time, the primary products we're aware of are Back & Forth (Pro-
  1478.       gressive Solutions) and Software Carousel (SoftLogic).  This category
  1479.       is an exception to our "everything works well with 4DOS" rule:  Soft-
  1480.       ware Carousel does work with 4DOS, but is designed to depend on
  1481.       COMMAND.COM and requires special care when used with 4DOS (see above
  1482.       for details).  Back & Forth works seamlessly with 4DOS, and many 4DOS
  1483.       users are enthusiastic about its features, support, and price.  Back
  1484.       & Forth contains a number of features specifically created with 4DOS
  1485.       in mind (for example, it knows that .BTM files are executable like
  1486.       batch files), and JP Software and Progressive Solutions communicate
  1487.       regularly to make sure that 4DOS and Back & Forth continue to work
  1488.       well together.
  1489.  
  1490.       Multitaskers:  For switching between applications and allowing more
  1491.       than one application to run at a time, the primary products are DESQ-
  1492.       View (Quarterdeck) and Windows 3.0 (Microsoft).  We have used both
  1493.       and find that for us they have different advantages and disadvantag-
  1494.       es.  We find DESQView to be more reliable than Windows but we also
  1495.       find Windows applications that use the Windows platform to do much
  1496.       more than what can be done under DESQView (for example the 4DOS 4.0
  1497.       manual text and pages were produced entirely in Word for Windows
  1498.       1.1).  You need to evaluate which of these programs meets your needs
  1499.       the best.
  1500.  
  1501.       Disk Caches:  There are dozens of products available in this catego-
  1502.       ry.  We use Super PC-Kwik (MultiSoft) and HyperDisk (Hyperware) and
  1503.  
  1504.  
  1505.  
  1506.  
  1507.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 26
  1508.  
  1509.  
  1510.       have found both to be reliable and to work well with 4DOS.  We can't
  1511.       speak from any direct experience about other caching programs.
  1512.  
  1513.       Disk Expanders:  We have had excellent results using Stacker (Stac
  1514.       Electronics) to expand disk drive space.  We currently run Stacker on
  1515.       both notebook and desktop systems.  We sometimes get a little less
  1516.       than Stac's claimed 2:1 disk space savings, but this is a minor point
  1517.       compared to Stacker's reliability, speed, and value.  There are other
  1518.       products which perform the same function; we have not used or evalu-
  1519.       ated any of them.
  1520.  
  1521.       Video Utilities:  We use UltraVision (Personics) regularly on all of
  1522.       our systems which have VGA video or better, and we use Laptop Ultra-
  1523.       Vision on laptop or notebook systems.  UltraVision allows excellent
  1524.       control over all aspects of VGA and EGA video systems including
  1525.       fonts, colors, and screen sizes.  It is fully compatible with 4DOS
  1526.       and many 4DOS users have found it to be a valuable tool.  We are not
  1527.       aware of any other products which do what UltraVision does.
  1528.  
  1529.       Boot Utilities:  We can't speak about this issue from any distance
  1530.       because we sell one such utility, BOOT.SYS, and use it on all our
  1531.       systems.  BOOT.SYS was the first of these utilities to allow selec-
  1532.       tion of a configuration during the boot process, and is an excellent
  1533.       tool for configuration management.  There are other products in this
  1534.       category but we are not familiar with them.
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.    4DOS 4.0  [11-18-91]          APPNOTES.DOC                       page 27
  1566.  
  1567.